home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 25 / CU Amiga Magazine's Super CD-ROM 25 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-08].iso / CUCD / Programming / ixemul / sdk / man / cat5 / resolv.conf.0 < prev    next >
Encoding:
Text File  |  1998-06-15  |  6.8 KB  |  124 lines
  1.  
  2. RESOLV.CONF(5)             UNIX Programmer's Manual             RESOLV.CONF(5)
  3.  
  4. NNAAMMEE
  5.      rreessoollvv..ccoonnff - resolver configuration file
  6.  
  7. DDEESSCCRRIIPPTTIIOONN
  8.      The rreessoollvv..ccoonnff file specifies how the resolver(3) routines in the C li-
  9.      brary (which provide access to the Internet Domain Name System) should
  10.      operate.  The resolver configuration file contains information that is
  11.      read by the resolver routines the first time they are invoked by a pro-
  12.      cess.  The file is designed to be human readable and contains a list of
  13.      keywords with values that provide various types of resolver information.
  14.  
  15.      On a normally configured system this file should not be necessary.  The
  16.      only name server to be queried will be on the local machine, the domain
  17.      name is determined from the host name, and the domain search path is con-
  18.      structed from the domain name.
  19.  
  20.      The different configuration options are:
  21.  
  22.      nnaammeesseerrvveerr  Internet address (in dot notation) of a name server that the
  23.                  resolver should query.  Up to MAXNS (currently 3) name
  24.                  servers may be listed, one per keyword.  If there are multi-
  25.                  ple servers, the resolver library queries them in the order
  26.                  listed.  If no nnaammeesseerrvveerr entries are present, the default is
  27.                  to use the name server on the local machine.  (The algorithm
  28.                  used is to try a name server, and if the query times out, try
  29.                  the next, until out of name servers, then repeat trying all
  30.                  the name servers until a maximum number of retries are made).
  31.  
  32.      ddoommaaiinn      Local domain name.  Most queries for names within this domain
  33.                  can use short names relative to the local domain.  If no
  34.                  ddoommaaiinn entry is present, the domain is determined from the
  35.                  local host name returned by gethostname(2);  the domain part
  36.                  is taken to be everything after the first `.'.  Finally, if
  37.                  the host name does not contain a domain part, the root domain
  38.                  is assumed.
  39.  
  40.      llooookkuupp      This keyword is used by the library routines gethostbyname(3)
  41.                  and gethostbyaddr(3).  It specifies which databases should be
  42.                  searched, and the order to do so.  The legal space-separated
  43.                  values are
  44.  
  45.                  bbiinndd  use the Domain Name server by querying the named(8)
  46.  
  47.                  ffiillee  search for entries in //eettcc//hhoossttss
  48.  
  49.                  yypp    talk to the YP system if ypbind(8) is running
  50.  
  51.                  If the llooookkuupp keyword is not used in the system's _r_e_s_o_l_v_._c_o_n_f
  52.                  file then the assumed order is bbiinndd ffiillee. Furthermore, if the
  53.                  system's _r_e_s_o_l_v_._c_o_n_f file does not exist, then the only
  54.                  database used is ffiillee.
  55.  
  56.      sseeaarrcchh      Search list for host-name lookup.  The search list is normal-
  57.                  ly determined from the local domain name; by default, it be-
  58.                  gins with the local domain name, then successive parent do-
  59.                  mains that have at least two components in their names.  This
  60.                  may be changed by listing the desired domain search path fol-
  61.                  lowing the sseeaarrcchh keyword with spaces or tabs separating the
  62.                  names.  Most resolver queries will be attempted using each
  63.                  component of the search path in turn until a match is found.
  64.                  Note that this process may be slow and will generate a lot of
  65.                  network traffic if the servers for the listed domains are not
  66.                  local, and that queries will time out if no server is avail-
  67.                  able for one of the domains.
  68.  
  69.                  The search list is currently limited to six domains with a
  70.                  total of 256 characters.
  71.  
  72.      ssoorrttlliisstt    Sortlist allows addresses returned by gethostbyname to be
  73.                  sorted.  A sortlist is specified by IP address netmask pairs.
  74.                  The netmask is optional and defaults to the natural netmask
  75.                  of the net.  The IP address and optional network pairs are
  76.                  seperated by slashes.  Up to 10 pairs may be specified, ie.
  77.  
  78.                  ssoorrttlliisstt 113300..115555..116600..00//225555..225555..224400..00 113300..115555..00..00
  79.  
  80.      ooppttiioonnss     Options allows certain internal resolver variables to be mod-
  81.                  ified.  The syntax is:
  82.  
  83.                  ooppttiioonnss ooppttiioonn ......
  84.  
  85.                  where option is one of the following:
  86.  
  87.                  ddeebbuugg    sets RES_DEBUG in _res.options.
  88.  
  89.                  nnddoottss::nn  sets a threshold for the number of dots which must
  90.                           appear in a name given to res_query (see
  91.                           resolver(3))  before an initial absolute query will
  92.                           be made.  The default for n is 1, meaning that if
  93.                           there are any dots in a name, the name will be tried
  94.                           first as an absolute name before any search list el-
  95.                           ements are appended to it.
  96.  
  97.      The ddoommaaiinn and sseeaarrcchh keywords are mutually exclusive.  If more than one
  98.      instance of these keywords is present, the last instance will override.
  99.  
  100.      The sseeaarrcchh keyword of a system's _r_e_s_o_l_v_._c_o_n_f file can be overridden on a
  101.      per-process basis by setting the environment variable LOCALDOMAIN to a
  102.      space-separated list of search domains.
  103.  
  104.      The ooppttiioonnss keyword of a system's _r_e_s_o_l_v_._c_o_n_f file can be amended on a
  105.      per-process basis by setting the environment variable RES_OPTIONS to a
  106.      space-separated list of resolver options as explained above.
  107.  
  108.      The keyword and value must appear on a single line, and the keyword (e.g.
  109.      nnaammeesseerrvveerr) must start the line.  The value follows the keyword, separat-
  110.      ed by white space.
  111.  
  112. FFIILLEESS
  113.      /etc/resolv.conf  The file rreessoollvv..ccoonnff resides in _/_e_t_c.
  114.  
  115. SSEEEE AALLSSOO
  116.      gethostbyname(3),  resolver(3),  hostname(7),  named(8)
  117.  
  118.      _N_a_m_e _S_e_r_v_e_r _O_p_e_r_a_t_i_o_n_s _G_u_i_d_e _f_o_r _B_I_N_D.
  119.  
  120. HHIISSTTOORRYY
  121.      The rreessoollvv..ccoonnff file format appeared in 4.3BSD.
  122.  
  123. 4th Berkeley Distribution        May 10, 1991                                2
  124.